8. Creating Calendar Object Resources

Creating calendar object resources is carried out by using a CalWS-SOAP addItem request targeted at the parent collection and containing the resource to be created. The response will contain the href of the newly created object.

The iCalendar entity in the request MUST contain only a single calendaring entity with any related overrides.

Table 27 — AddItemType fields

Field

Type

#

?

Description

href

string

1

Y

Identify the target of the request.

icalendar

xcal:IcalendarType

1

Y

The entity to be created

The service will respond with an AddItemResponseType giving either the href and change token of the new entity or an error response.

Table 28 — AddItemResponseType additional fields

Field

Type

#

?

Description

href

string

0..1

N

Href of the new entity for a successful request.

changeToken

string

0..1

N

Change token for the new entity